Handling a Dynamic HTML Document
The Dynamic Document option of the HTML Document level affects all HTML screen elements that have been captured under the document. When this option is turned off, an HTML element is polled every 8 seconds in Runtime. It is much slower than with the Dynamic Document option turned on. Dynamic Document option triggers the polling interval specified in the System Settings window. For more information, see Changing the Polling Interval.
On some web sites DHTML elements are not recognized if the Dynamic Document option is not checked.
The example below demonstrates the performance improvement when the Dynamic Document option is enabled.
To demonstrate the performance improvement:
| 1. | In Real-Time Designer, capture an item on a dynamic menu, for example, the Language menu in https://twitter.com. |
On some web sites, a Dynamic HTML element appears only when your cursor hovers over it. In this case, you cannot capture it by clicking the Capture option in Real-Time Designer. To complete the capturing process, you must move the cursor over the target object in Internet Explorer in order to display it on the page, and then use the capturing shortcut Win+C (this hot key works on Windows 7 and below only).
| 2. | Select the captured HTML screen element in the Screen Elements tree, and select the Visibility self property in the Identification tab. |
By default, the Dynamic Document checkbox is cleared for the hidden HTML Document level.
| 3. | Run the project and select Monitor. For more information, see Running the Monitor. |
| 4. | Click the Screen Element tab and expand the object hierarchy to see the recognition state of captured HTML element. |
| 5. | Go to https://twitter.com and click the Language menu to make it visible. |
The captured HTML Hyperlink screen element is recognized by the Real-Time Client in Monitor only after eight seconds when the screen element becomes visible.
| 6. | Click the Language menu to hide it. |
Eight seconds after the screen element is not visible, the HTML Hyperlink screen element is no longer recognized by the Monitor.
| 7. | Stop Real-Time Client, then select HTML Document level in the Screen Elements tree in Real-Time Designer. |
| 8. | Select the Dynamic Document option in the Identification tab. |
| 9. | Run the project and select Monitor. |
| 10. | Click the Screen Element tab and expand the object hierarchy in order to see the recognition state of captured HTML element. |
| 11. | Go to https://twitter.com and click the Language menu to make it visible. |
One second after the HTML Hyperlink screen element becomes visible, it is recognized by the Real-Time Client. This is much faster than when the Dynamic Document option is not checked.
The polling interval for Dynamic Document option can be changed. For more information, see Changing the Polling Interval.
| 12. | Click the Language menu to hide it. |
One second after the HTML Hyperlink screen element becomes invisible, it is no longer recognized by the Monitor.
The Polling Interval setting is used only when the Dynamic Document option is checked in the Identification tab for an HTML Document.
To change the polling interval:
| 1. | In Real-Time Designer, open the System Settings window. |
| 2. | Expand the Real-Time Client node and select Screen Connectivity General Configuration. |
The default polling interval is 1000 milliseconds. Valid values are between 1 and 3000 milliseconds.
OuterHTML Algorithm for Handling Dynamic Documents
Real-Time Solutions use an improved algorithm to identify DHTM elements. This algorithm checks the captured HTML screen element each time the OuterHTML is changed in the dynamic document.
To enable the OuterHTML algorithm:
| 1. | In Real-Time Designer, open the System Settings window. |
| 2. | Expand the Real-Time Client node. |
| 3. | Select the IE Plugin Configuration. |
| 4. | Change Use OuterHTML for Dynamic document setting to True. |
The OuterHTML for Dynamic document option triggers the algorithm of the DHTML element's identification. If this option is set to False, the screen element is searched for by the number of elements. When set to True, the screen element is searched each time that OuterHTML is changed in a web page.

